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ROFF MANUAL 


PURPOSE: 


kotf£ is a tairly simple ‘word processing’ program, The name 
ratf£ is short for "runoff". This manual is an example of its 
WOrK. 


Tne roff program is of no particular use on simple letters 
which need not be perfect, and which will never be revised. But 
if a document is lengthy, and is likely to need correction or 
revision at a later time, then roff is invaluable. Once all 
typos are found and corrected in a roff file, they will never 
reappear. If you change a single sentence in a document only 
that sentence need be retyped, and only that sentence. need be 
proof-read. 


LURUT: 


Text to be printed and instructions for printing occur in= 
termixed on separate lines. Instruction lines, called requests, 
pegin with a cantrol Character (usually "."). 


QULRUL: 


Vutput lines may be filled as nearly as possible with words 
without regard to input lineation, or may be copied one=for-one 
from input text. Right margin justification may be performed on 
filled lines. Breaks between output lines are torced by certain 
requests-and py input text lines beginning with blanks. Indenta= 
tion, centering, line length, line spacing, page length, titling, 
page numbering, and hyphenation are controllable. 


USAGE: 
Roff is invoked from command level by typing = 
roft +N -M namel name 2 oe. 
where namel, name2, etc., are the names of the documents that are 
to be formatted together as a single document. Normally the 
entire document is printed; if +N is specified, printing will 
begin with numbered page N; if -M is specified, printing will end 
with number page M. For example: 
roff +5 -9 filel file2 


will print pages five through nine from the documents found in 
“¢iiet* and *titer. 
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THE @aSLC BUEE REQUESTS: 


Signs + of = may precede numbers denoted +n. Unsigned 
numpers replace current values. Signed numbers add to or sub- 
tract from current values == i.,e., +m causes the current value to 
pe increased by N- and -n causes the current value to be de- 
creased py ne A missing n is equivalent to. n= 1... Requests 
requiring titles have the initial setting t = °’’’. The initial 
settings for otner parameters are given in the table below, Cer- 
tain requests cause line hreaks. 


regquesiL oneak initial meaning 
ead yes yes begin adjusting rignt margins. 


br yes causes a line break = the filling of the 
current line is stopped. 


ool n- yes insert contiguous block of n blank lines. 
It necessary, a new page will be started 
to accommodate the entire block. 


eop yes hegin new gage. 
cc Ct no c=. control character becomes ‘Cc’. 
ece n yes center the next n input lines, without 
filling. : 
eae xx. 0 define a sequence of requests (to save 
typing effort). 
ee no the *..’ request terminates a ".de" 
ds yes no double space; same as ".1s 2". 
ef t no t=°*'*’ even foot title becomes t. 
eeh t no t='°"" even head title becomes = 
o fi yes yes begin filling output lines. 
efo no t=°*** all £oot titles are t. 
«he c no c=??? byphenation character set to et oa 
= 2: 
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all head titles are t. 


hyphenation is done, if n=1; and is not 


done, if n=0. 
indent n spaces from left margin. 
literal, treat next n lines as text. 


line length including indent is n charace 
ters. : 


line spacing set to n lines per output 
line. 


n blank lines are put between the top of 
a new page and the head title. 


n blanks lines put between head title and 
peginning of text on page. 


n blank lines put between the end of text 
and the foot title. 


n blank lines put between the foot title 
and the bottom of page. 


stop adjusting the right margin. (no 
adjust) 


begin new page, if n output lines cannot 
fit on present page. (need) 


the next output line is not numbered. 
output lines are numbered sequentially 
beginning with 1 on each new page. Head 
and foot titles are not numbered. 


output lines are numbered sequentially 
beginning with 1 on the next output line. 


stop tilling output lines. (no £111) 


odd foot titles become t. 


SET RET ATE LENE SET, TS TR CE I ET TT 
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Ve no 
+n yes 
+n no 
n no 
n no 
n yes 
no 
+n yes 
adCdees 
n no 


no 


yes 
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odd head titles become t. 


begin new page and number it n. 


total paper length taken to be n lines. 
page offset set ton 

n pages with head and foot titles but 
otherwise blank will be output beginning 
with the next page containing text. 
insert block of n blank lines. If the 
bottom of a page is reached, remaining 
lines are nat put on next page. 


single space output lines, equivalent to 
Oe foe 


temporarily indent next output line n 
spaces. 


translate a into b, ¢ into d, etc. 


underline the letters and numbers on the 
next n input lines. 


Fan te Shae 
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ROFF Tutorial Guide: 


Tne title line, "ROFF Tutorial Guide," and this first para-~ 
4yrapn were set up by the input that follows. Tne title was 
spaced down one extra line (.sp) and centered Cice). The pare= 
graph begins after another spacing line and is_ double spaced 
(.dS). 1 typed the paragraph without attention to lines; Roff 
took care of tilling them. I put each sentence on a_e separate 
line to make editing easier. 


«SD 

ece 

Tutorial Guide . 

Pay) 

ds 

2th 45 

The title line, “ROFF Tutorial Guide," and this first 
paragraph were set up by the input that follows. 
The title was spaced down one extra line (.sp) and 
centered (.ce). 

The paragraph begins after another spacing line 
and is double spaced (.dS)-. ; 

I typed the paragrapn without attention to lines; 
Roff took care of filling them. 

I put each sentence ona separate line to make 
editing easier. ' 


Heads and feet. 

Tne head and foot titles for this Manual were set up by the 
following requests: 

ene °*ROFF MANUAL*’® 

seo. Seg ae" ‘ 
Quote: marks split the foot up into parts for the left, middle, 
and right side of the page. The % mark shows where the page 


number is to go. 
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lf you want different head and/or foot titles on even and 
odd numpered pages, the "en", "on", “.ef", and ",of" requests 
can pe used. They should be placed somewhere after the beginning 
of the first page so as to cause numbering of pages 2, 3, and so 
on. For example, the following requests put the page number on 
the outer edge of each page, as wie be desired when the text will 
be printed on both sides of the paper. 

een “Page %°°’ 

.oh °**Pages’ 

Line breaks. 

In ordinary paragraph text, roff takes care of filling lines 
with words, but there are places where one wants to control ex-= 
actly wnere the line ends. The title "Tutorial Guide," should 
have a line to itself, and each paragraph is expected to begin on 
anew line, not just run on to the paragraph before. Certain 
requests, among them .ce and .Sp, cause line breaks. The request 


list on pages 2 and 3 tells exactly which. 


Sometimes, every line break is important. One could place a 
simple break (.br) request between every pair of lines, 4s in 
Poe’s first stanza below, but it is easier to shut off all fil- 
ling of lines by “.nf" (no fi11) as in the second. “.fi" turns 
filling on again. 

- Gaily bedight, 

br 

A valiant Knight, 

sor 

In sunsnine and in shadow, 


= 6 = 
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eOF 
Had journeyed long, 
ebr 
Singing a song, 
aDt 
In search for Eldurado, 
2sp 
ent 
But ne grew old, 
This Knight so bold, 
And o’er his heart a shadow, 
Fell, as he found, 
No spot of ground, 
That looked like Eldurado. 


efi 


Justificatian and indentation. 

All the paragraphs up to now have been justified; that is, 
enough extra spaces have been put into every line to align the 
right margin exactly. Ordinary typewriter style with an uneven 


right margin results from a no justification (ena) request. 


Lines may still be filled even with justification off, but: juse 
tification is never done when no fill (.nf) is in effect. 
ena 
sti: FO 
This paragraph is not justified. It was surrounded by 


the no justification (.na) and justification (.ad) requests that 


you see, made visible by some trickery. The first line was in- 
dented 10 spaces by a temporary indent (.ti) request that holds 
for exactly one line. 

ead 


«SD 
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Sf Siena betagi oi RN 


an 5° 
2 ae 
sba- 99 

This paragraph was indented (.in) 5 spaces 
and the right margin was placed at 55 instead of 
the usual 65 by setting the line length. (.11). 
(Tne line length includes the indentation.) Inden- 
tation and line length may also be changed by 
addition and subtraction as in ".ti +5". Notice 
that a break (in this case caused by ".sp") 


precedes the resetting of margins after the param 


ers a eee ee 


graph. Neither ",in" or ".11" cause a break, and 
strange things can happen if you unconsciously 
asSume they do! 
esp 
Ei 6S 
ein 0 
Rages and widows. 
Several requests affect the numbering of pages, Or Cause a 
new page to begin. 
bp -pegins a page 
epa n begins a page and sets its number to n 


SK on causes the next n physical pages 
to be blank, except for head and foot titles. 


"op" has exactly the same effect as ".pa +1". “.sk" is useful 


for setting aside space for full page illustrations. 


Ordinarily, roff begins a new page only when the page before 


=» § = 


sai 


niet : 
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is tilled up. It can very easily create widows, isolated lines 
that really belong with the page before or the page after. Typi- 
cal cases are a subhead that falls at the bottom of a page, oF 
the last couple of words of a paragraph that fall at the top. 
When a widow does crop up, you can fix it with a need (.ne) re= 
quest. In the next example, .ne 4 says no more lines should be 
put on the current page unless four lines can be put there, thus 
assuring that at least the first two lines of the single-spaced 
(.8S) paragraph go along with the subhead. 

oss 

ene 4 


ece 
Control of Radioactive Pollution 


esp 
No really effective therapy is known for 


preventing or curing the harmful effects 
of internal contamination by 
radioactive nuclides. 


Need requests come in handy as well for guaranteeing that a table 


or a set of equations not be split across pages. 


Underlininog. 

The best way to do underlining is to use the .ul request 
which causes the next line of input to be underlined regardless 
of line filling. Putting underlines into filled text by back- 
spacing and overstriking is a ticklish-arocedure that can give 


_troublesoameeffects__, as this sentence shows. 


* 


whicn causes the 

eul 

next line of input 

to be underlined regardless of line filling. 


= 9 «= 
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Putting underlines into filled text by 
packspacing and over striking is a 
Licklish.uracedure 

Lhatcap.gqive trounlesame.efifects, as this 
sentence shows, 


Punctuation characters are not touched by ".ul". To underline 
punctuation you will have to overstrike, observing the cardinal 


rule for typing filled text: Never hackspace across a Space, 


Literal. 

Occasionally you may want to type a line beginning with a 
period, which roff will try to interpret as a request -= even 
when no such request exists. A literal (.11) request put right 
before the line will prevent roff from mistakenly trying to ine 
terpret it and cause the line to be accepted as ordinary text. 


eit 
«Sp this couldn’t be printed without .li 


Hypbenation. 

To improve the fit, roff ordinarily tries to hyphenate at 
the end of the filled lines. The hyphenation mode request "hy" 
is used to control whether or not nyphenation is attempted. 
".no" will turn off all hyphenatinon by roff. ".hy 1" will turn 
a0 On. When hyphenating, roff wiils (1) hyphenate words con- 
taining a "=" (literal hyphen) only at these hyphens; (2) hyphen= 
ate. words containing bypbenation characters (set by ".hc") only 


at these characters; (3) hyphenate other words according to an 


= 10° 


renee raeepae 
AON niem 
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- 


algorithm based on .suffix analysis and on diagram hyphenation 
probapilities. Hyphenation may be turned off locally -by sur= 
rounding the text with ",ny 0" and ".hy 1". Hyphenation may be 
turned off in a single word by having it begin with a hyphenation 


character.. 


Translation. 
Translation can be used to overcome some unpleasing results. 
of justification and filling, such as 
(1) extra spaces between an "undented" paragraph 
number and its paragraph 


(2) an unwanted break inside a formula: 1 + 
X + X#*¥2/2!) + X¥FFI/3! + wee 


To fix up such annoyances, you may designate an otherwise unused 
character, say °*”*%, to be translated (.tr) into a space. Though 


it will print as a space, roff does not treat it as such, and so 


won’t pad or break lines there. 


«ti =4 

(1)"extra spaces between an "“undented" paragraph 
number and its paragraph 

ati =4 

(2)"an unwanted break inside a formula: 

1a KE XERZ/2 I 4X ERIS Nt eee 


The prettied-up result follows. 
(1) extra spaces between an “undented" paragraph 
’ number and its paragraph 


(2) an unwanted break inside a formula: 
1+ x ¢ x¥¥*2/2! + x¥#3/31 + wee 


= ili. 


